home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 051-075 / scopedisk61 / intouch3 / readme < prev    next >
Text File  |  1995-03-19  |  10KB  |  210 lines
  1. ==========================================================================
  2.  
  3.                          I- n - T - o - u - c - h
  4.                         ==========================
  5.  
  6. ==========================================================================
  7.                           By Khaled Mardam-Bey.
  8.                        LAD on PeopleLink and Portal.
  9. ==========================================================================
  10.   preliminary release docs - version 3.0
  11. ==========================================================================
  12.  
  13.   This is a very lightly spiced up version of Comm134. I wrote it because
  14.   I really liked the original Comm134, and didn't like any of the other
  15.   terminal programs available (PD, shareware or commercial). I wanted a
  16.   program which was still basically Comm134, but with a little bit more
  17.   added to it.
  18.  
  19.   I've fixed/added/replaced/removed many bits and pieces.
  20.  
  21.   Gosh... I don't know where to begin.
  22.   Here goes nothing..
  23.  
  24.   1> Scroll Buffer
  25.      -------------
  26.  
  27.      In ANSI mode :  use the ARROW KEYS.
  28.                   if buffer is CLOSED then UP and RIGHT arrow keys
  29.                   open buffer at the END.
  30.                   DOWN and LEFT arrow keys open buffer at the START.
  31.  
  32.                  while buffer is OPEN, UP scrolls upwards through
  33.                  buffer and DOWN scrolls downwards through the buffer.
  34.                  LEFT positions buffer at START and RIGHT positions
  35.                  buffer at END.
  36.  
  37.                  to EXIT buffer, press the RETURN key.
  38.  
  39.      In VT100 mode :  use the ARROW KEYS with SHIFT key.
  40.                    the SAME as in ANSI except with the SHIFT key held
  41.                    down at all times.
  42.  
  43.      ARROW KEYS in VT100 mode send out appropriate vt100 cursor codes if
  44.      NOT pressed with shift.
  45.  
  46.   You can ALSO use the MOUSE to OPEN, CLOSE, and SCROLL through the
  47.   buffer. there is a BUFFER GADGET -->BELOW<-- the WINDOW TO FRONT gadget
  48.   in the top right hand corner of the screen. If the buffer is CLOSED
  49.   then clicking this gadget will open it; if it is open then clicking
  50.   it will close the buffer.
  51.  
  52.   if you press the LEFT mouse button and HOLD it DOWN in the LOWER half
  53.   of the window, then you will scroll down through the buffer. If in the
  54.   upper half of the window, then you will scroll upward through the buffer.
  55.  
  56.   clicking EITHER the CLOSE WINDOW gadget OR the BUFFER gadget will exit
  57.   the buffer mode.
  58.  
  59.   Use RIGHT-AMIGA and '/' to CLEAR the buffer.
  60.   Use LEFT-AMIGA and '-' to decrease buffer size by 50 lines.
  61.                      '+' to increase buffer size by 50 lines.
  62.   Maximum buffer size is 500 lines.
  63.   Minimum buffer size is 0 lines. (no buffer).
  64.   (decreasing buffer size CLEARS the buffer completely, but increasing
  65.   it does NOT.)
  66.  
  67.   In Buffer mode, Mouse Pointer will change to the letters BUFF.
  68.  
  69.   no keystrokes will be output to the serial port while in buffer
  70.   mode. No menu items are available in buffer mode. The HELP key does
  71.   operate though.
  72.  
  73.   You can see current buffer size by pressing the HELP key. default is
  74.   set at 200 lines. Memory for buffer is dynamically allocated and
  75.   deallocated. Buffer works in ALL screen and window modes.
  76.  
  77.   When exiting buffer mode, cursor is positioned exactly where it was
  78.   before entering buffer mode. ie. if you were in the middle of typing
  79.   a line, cursor will be repositioned in the same place at end of line.
  80.  
  81.   if you are at the TOP of the buffer, and there is more input from the
  82.   serial port, buffer will automatically scroll down a line at a time.
  83.   (otherwise i would have needed a buffer for the buffer.. :-)
  84.  
  85.   I added a another function : If you want the last screen-full of buffer
  86.   contents to be output to your screen EACH time you switch/resize windows,
  87.   or switch interlace/etc. ie. anytime where using a fucntion clears your
  88.   screen, then use RIGHT-AMIGA and '\'. This will toggle AutoScroll ON/OFF.
  89.   (It's hard to explain, just try it... :-)
  90.  
  91.   2> cursor keys send out appropriate codes for vt100 emulation ONLY in
  92.      vt100 mode, and NOT in ANSI mode.
  93.  
  94.   3> RIGHTAMIGA and ';' CLEARS the screen in both VT100 and ANSI mode.
  95.  
  96.   4> RIGHTAMIGA and keys '1' to '9' below the function keys change the size
  97.      of the Split Window. (if it's not open, it WILL be opened at chosen
  98.      size, otherwise will simply be resized).
  99.  
  100.      No split window available when on WB screen.
  101.  
  102.   5> RIGHTAMIGA and keys '0' to '9' on the NUMERIC KEYPAD dial the first
  103.      TEN numbers in the phone menu.
  104.  
  105.   6> When you select Phone numbers in Auto-Redial mode, they will be
  106.      highlighted in the Phone Menu. You cannot select any other phone
  107.      numbers until you EXIT Auto-Redial mode.
  108.  
  109.   In autoredial mode, if "Not On" then dials as normal. if number of seconds
  110.   is chosen, then will autoredial number again and again until told to stop.
  111.   Click on as many phone numbers as you want, and they will all be auto-
  112.   redialed. (by the way, if you press RETURN while waiting to connect
  113.   in autoredial mode, you will exit redial mode WITHOUT hanging up phone.
  114.   this is for cases when timer is reaching 0 seconds and you are about to
  115.   connect).
  116.     Auto-Redial modle isn't perfect, BUT it does work. If you hold down
  117.   the right (menu) mouse button for too long, it might mess up the timer
  118.   because InTouch is outputting to the screen. Not a big hassle really,
  119.   since most menu items are blanked out anyway.
  120.  
  121.     Also, as in Comm134, if you have a MacroKey file by the same name as
  122.   the name in the phone menu, it will load those Macros. BUT, if InTouch
  123.   can't find that MacroKey file, it will LOAD the default Comm.keys file,
  124.   EVERYTIME. (if it can, otherwise macros remain as they are).
  125.     You can also specify the FN81 values in the phone file.
  126.  
  127.   NOTE : in autoredial mode, the MODEM must NOT be in halfduplex mode.
  128.   ie. it must not echo back any characters that are sent out to it. This
  129.   is because after InTouch has dialed, it expects any serial activity
  130.   to represent a CONNECT/BUSY/OK/NO CARRIER/etc.
  131.  
  132.   7> The vt100 mode was taken directly out of Dave Weckers vt100, v2.8.
  133.      The cursor flickers a bit, but can't find a way around that as of
  134.      yet. There is an option in the menu called "Mouser". A la the Wombat
  135.      vt100/52 emulator, if this option is ON, clicking IN the main window
  136.      will then send out control codes to reposition the cursor to that
  137.      specific point. This works ONLY in vt100 mode. By the way, when using
  138.      the MOUSER option, don't forget there's a CLOSE gadget in the top
  139.      left hand corner of the screen.. I've already closed my screen a couple
  140.      of times that way... :-)
  141.  
  142.   8> You can toggle Interlace screens, either use workbench screen or it's
  143.      own screen, toggle title bar, toggle borders of window, choose
  144.      whether you hear BEEP or see FLASH or both. FLASH flashes ALL screens.
  145.      
  146.   9> Choosing certain menu items may blank out other menu items. example,
  147.      choosing vt100 mode means no split window allowed, also if you are
  148.      using the WB screen, only borderless mode is allowed in vt100.
  149.        Fiddle around.
  150.  
  151.   10> The File Requestor now has a PARENT gadget in the top left hand corner
  152.       to allow easy backpacing through directories. You can also select
  153.       directories within directories (fixed that bug).
  154.  
  155.   11> When you type SHIFT-HELP, if the Macro list is larger than the window,
  156.       it will wait for you to press a key, and then continue..
  157.  
  158.   12> Whenever you try to load macros or a phonelist, if InTouch can't find
  159.       the specified file, it will load in the default file. (Comm.keys and
  160.       Comm.phone). You also don't get System requesters popping up anymore.
  161.  
  162.   13> Added the time and scroll buffer size to the HELP window.
  163.       You can't edit macros anymore.
  164.  
  165.   I have a feeling I've forgotton to mention some other things.
  166.  
  167.   I've added other bits and pieces to make life easier and more
  168.   fun while using InTouch. To me, this is still Comm. It's not
  169.   really InTouch, but more of a Comm2.00 or a Comm3.00 instead.
  170.  
  171.   Basically, I've tried to keep it simple and obvious. Functional,
  172.   yet user friendly. As close to Comm134 as I could keep it.
  173.   No awards for color or styling here.
  174.   No awards for flexibility or superior ability to other Terminal
  175.   programs. It does what it does. that's all.
  176.  
  177.   Considering the stuff I've added and modified/fixed (and some stuff
  178.   taken away) an increase of only 13k in code size isn't bad at all.
  179.   (or is it ?).
  180.  
  181.   Definite possible additions
  182.   ---------------------------
  183.   Zmodem will be a most needed addition.
  184.   The ability to strip vt100/ansi/other control codes.
  185.  
  186.   Possible possible additions
  187.   ---------------------------
  188.   Ability to save/cut/send Buffer contents.
  189.   arexx support ? hmmm.
  190.   scripts ?
  191.  
  192.   The definite additions are things I personally need. The possible
  193.   additions are more "let's see how many really neat things I can
  194.   add to this program, but which I really have no use for" thoughts.
  195.   So they are actually remotely remote possibly possible additions.
  196.   Arexx support might be interesting though.
  197.  
  198.   Comments/Bug reports/suggestions to LAD on peoplelink and portal.
  199.   I can also be reached on Bifrost BBS, 1-301-948-6286.
  200.  
  201.   TADAAA. enjoy.
  202.  
  203.            Khaled Mardam-Bey.
  204.  
  205. ==========================================================================
  206.   Thanks ofcourse to Dan James for his Comm134 program and source (and
  207.   help..!) and to Dave Wecker for his vt100 source code, as well as
  208.   everyone else who's helped me out...
  209. ==========================================================================
  210.